package xs.szw.service.config;

import io.swagger.v3.oas.models.ExternalDocumentation;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Info;
import lombok.extern.slf4j.Slf4j;
import org.springdoc.core.models.GroupedOpenApi;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * @program: My_SpringSecurity
 * @description: swagger3
 * @author: Songzw
 * @create: 2025-01-27 20:12
 **/
@Configuration
@Slf4j
public class Swagger3Config
{
    /**
     * 配置一个组(可配置多个组)
     * @return
     */
    @Bean
    public GroupedOpenApi clientApi()
    {
        // 配置该组包含的的接口路径
        return GroupedOpenApi.builder().group("client").pathsToMatch("/**").build();
    }


    /**
     * 配置api文档描述
     * @return
     */
    @Bean
    public OpenAPI docsOpenApi()
    {
        log.info("创建openai bean");
        return new OpenAPI()
                //标题
                .info(new Info().title("OA审批")
                        //描述
                        .description("云办公")
                        //版本
                        .version("v3.0"))
                //外部文档描述
                .externalDocs(new ExternalDocumentation()
                        .description("柯易科技有限公司技术部--Songzw")
                        .url("https://keyiCode.com/"));
    }
}
